package com.alibaba.service;

import com.alibaba.model.entity.Activity;
import java.util.List;

/**
 * 活动服务接口，定义活动相关的常用操作方法。
 */
public interface ActivityService {

    /**
     * 查询所有活动信息
     * @return 活动列表
     */
    List<Activity> listAllActivities();

    /**
     * 查询正在进行中的活动（如当前时间在活动开始和结束时间之间）
     * @return 进行中活动列表
     */
    List<Activity> listOngoingActivities();

    /**
     * 根据活动ID查询活动详情
     * @param activityId 活动ID
     * @return 活动详情，若不存在返回null
     */
    Activity getActivityById(Long activityId);

    /**
     * 新增活动
     * @param activity 活动实体
     * @return 是否添加成功
     */
    boolean addActivity(Activity activity);

    /**
     * 更新活动信息
     * @param activity 活动实体
     * @return 是否更新成功
     */
    boolean updateActivity(Activity activity);

    /**
     * 删除活动
     * @param activityId 活动ID
     * @return 是否删除成功
     */
    boolean deleteActivity(Long activityId);
}
